home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / X11 / lndir.z / lndir
Encoding:
Text File  |  2002-10-03  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      LLLLNNNNDDDDIIIIRRRR((((1111))))           XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))            LLLLNNNNDDDDIIIIRRRR((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           lndir - create a shadow directory of symbolic links to
  10.           another directory tree
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           llllnnnnddddiiiirrrr [ ----ssssiiiilllleeeennnntttt ] [ ----iiiiggggnnnnoooorrrreeeelllliiiinnnnkkkkssss ] _f_r_o_m_d_i_r [ _t_o_d_i_r ]
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           The _l_n_d_i_r program makes a shadow copy _t_o_d_i_r of a directory
  17.           tree _f_r_o_m_d_i_r, except that the shadow is not populated with
  18.           real files but instead with symbolic links pointing at the
  19.           real files in the _f_r_o_m_d_i_r directory tree.  This is usually
  20.           useful for maintaining source code for different machine
  21.           architectures.  You create a shadow directory containing
  22.           links to the real source, which you will have usually
  23.           mounted from a remote machine.  You can build in the shadow
  24.           tree, and the object files will be in the shadow directory,
  25.           while the source files in the shadow directory are just
  26.           symlinks to the real files.
  27.  
  28.           This scheme has the advantage that if you update the source,
  29.           you need not propagate the change to the other architectures
  30.           by hand, since all source in all shadow directories are
  31.           symlinks to the real thing: just cd to the shadow directory
  32.           and recompile away.
  33.  
  34.           The _t_o_d_i_r argument is optional and defaults to the current
  35.           directory.  The _f_r_o_m_d_i_r argument may be relative (e.g.,
  36.           ../src) and is relative to _t_o_d_i_r (not the current
  37.           directory).
  38.  
  39.           Note that RCS, SCCS, CVS and CVS.adm directories are not
  40.           shadowed.
  41.  
  42.           If you add files, simply run _l_n_d_i_r again.  New files will be
  43.           silently added.  Old files will be checked that they have
  44.           the correct link.
  45.  
  46.           Deleting files is a more painful problem; the symlinks will
  47.           just point into never never land.
  48.  
  49.           If a file in _f_r_o_m_d_i_r is a symbolic link, _l_n_d_i_r will make the
  50.           same link in _t_o_d_i_r rather than making a link back to the
  51.           (symbolic link) entry in _f_r_o_m_d_i_r.  The ----iiiiggggnnnnoooorrrreeeelllliiiinnnnkkkkssss flag
  52.           changes this behavior.
  53.  
  54.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  55.           -silent
  56.                Normally _l_n_d_i_r outputs the name of each subdirectory as
  57.                it descends into it.  The ----ssssiiiilllleeeennnntttt option suppresses
  58.                these status messages.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      LLLLNNNNDDDDIIIIRRRR((((1111))))           XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))            LLLLNNNNDDDDIIIIRRRR((((1111))))
  71.  
  72.  
  73.  
  74.           -ignorelinks
  75.                Causes the program to not treat symbolic links in
  76.                _f_r_o_m_d_i_r specially.  The link created in _t_o_d_i_r will
  77.                point back to the corresponding (symbolic link) file in
  78.                _f_r_o_m_d_i_r.  If the link is to a directory, this is almost
  79.                certainly the wrong thing.
  80.  
  81.                This option exists mostly to emulate the behavior the C
  82.                version of _l_n_d_i_r had in X11R6.  Its use is not
  83.                recommended.
  84.  
  85.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  86.           The program displays the name of each subdirectory it
  87.           enters, followed by a colon.  The ----ssssiiiilllleeeennnntttt option suppresses
  88.           these messages.
  89.  
  90.           A warning message is displayed if the symbolic link cannot
  91.           be created.  The usual problem is that a regular file of the
  92.           same name already exists.
  93.  
  94.           If the link already exists but doesn't point to the correct
  95.           file, the program prints the link name and the location
  96.           where it does point.
  97.  
  98.      BBBBUUUUGGGGSSSS
  99.           The _p_a_t_c_h program gets upset if it cannot change the files.
  100.           You should never run _p_a_t_c_h from a shadow directory anyway.
  101.  
  102.           You need to use something like
  103.                find todir -type l -print | xargs rm
  104.           to clear out all files before you can relink (if fromdir
  105.           moved, for instance).  Something like
  106.                 find . \! -type d -print
  107.           will find all files that are not directories.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.